home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2001 May / SGI IRIX Base Documentation 2001 May.iso / usr / relnotes / performer_eoe / ch2.z / ch2
Text File  |  2001-04-17  |  10KB  |  330 lines
  1.  
  2.  
  3.  
  4.                                   - 1 -
  5.  
  6.  
  7.  
  8.        2.  _I_n_s_t_a_l_l_a_t_i_o_n__I_n_f_o_r_m_a_t_i_o_n
  9.  
  10.        This chapter lists information supplemental to the _I_R_I_S
  11.        _S_o_f_t_w_a_r_e _I_n_s_t_a_l_l_a_t_i_o_n _G_u_i_d_e. The information listed here is
  12.        product-specific; use it with the Installation Guide to
  13.        install this product.
  14.  
  15.  
  16.        2.1  _P_r_e_r_e_q_u_i_s_i_t_e_s
  17.  
  18.  
  19.        To use OpenGL Performer 2.4, your system must be running
  20.        IRIX 6.2 or later. OpenGL Performer 2.4 supports all
  21.        graphics configurations that are running at least IRIX 6.2.
  22.        In order to develop MIPS-III/IV applications you must
  23.        install the appropriate selection of N32 and N64 subsystems
  24.        as listed in the distribution.  N32 and O32 are combined as
  25.        the standard system default.  OpenGL Performer developers
  26.        will also need a C or C++ compiler, the Performer database
  27.        loaders, and associated software development tools and
  28.        libraries.
  29.  
  30.  
  31.        OpenGL Performer is dependent on the general system
  32.        configuration so there are things outside of the OpenGL
  33.        Performer 2.4 distribution that you will need.  If running
  34.        IRIX 6.2, IRIX 6.3, or IRIX 6.4, we strongly recommend
  35.        installing the latest kernel, graphics and X rollup patches.
  36.        If running IRIX 6.5, we strongly recommend upgrading to the
  37.        latest overlay version.
  38.  
  39.        Prerequisites for OpenGL Performer 2.4 for Linux are listed
  40.        in the on-line notes installed in /usr/doc/performer-2.4
  41.        (Linux only).
  42.  
  43.  
  44.        2.2  _O_p_e_n_G_L__P_e_r_f_o_r_m_e_r__E_O_E__S_u_b_s_y_s_t_e_m_s
  45.  
  46.  
  47.        Many subsystems comprise the OpenGL Performer execution
  48.        environment distribution.  These subsystems are not all
  49.        required for a proper installation.
  50.  
  51.        The IRIX environment spans two machine architecture levels
  52.        -- the 32-bit MIPS I/II instruction set and the 64-bit MIPS
  53.        III/IV instruction set -- along with two versions of 32-bit
  54.        support -- the old caller-save register management protocol
  55.        known as Old-32 and the newer callee-save register
  56.        management protocol termed New-32 (N32) -- so there are
  57.        actually three versions of each library: O32, N32, and N64.
  58.        The _f_i_l_e2 IRIX shell command can tell you what version of
  59.  
  60.  
  61.  
  62.  
  63.  
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.                                   - 2 -
  71.  
  72.  
  73.  
  74.        the MIPS instruction set is being used by a given
  75.        executable.  The O32 and N32 libraries are combined in a
  76.        single subsystem to simplify installation.
  77.  
  78.        This multidimensional complexity is hidden within OpenGL
  79.        Performer since the APIs are unchanged between the versions.
  80.  
  81.        The subsystem naming conventions are designed to be simple
  82.        and regular:
  83.  
  84.           +o Old-32 32-bit mips-2 and New-32 32-bit libraries are in
  85.             ".sw" subsystems.  The Old-32 were the standard IRIX
  86.             6.2 libraries and are now provided only for backwards-
  87.             compatibility.  They may be removed in a future
  88.             release.  The New-32 libraries were introduced with
  89.             IRIX 6.2 and operate with increased efficiency in many
  90.             situations.  N32 is the default mode of operation in
  91.             Performer 2.4.
  92.  
  93.           +o New-64 64-bit libraries are in ".sw64" subsystems.
  94.  
  95.           +o Only the optimized libraries are included in the
  96.             execution environment.
  97.  
  98.        A few simple examples should make the naming conventions
  99.        clear:
  100.  
  101.           +o performer_eoe.sw.performer: O32 and N32, OpenGL,
  102.             Optimized, DSO
  103.  
  104.           +o performer_eoe.sw64.performer: N64, OpenGL, Optimized,
  105.             DSO
  106.  
  107.        OpenGL Performer includes these subsystems whose names were
  108.        composed following the conventions outlined above:
  109.  
  110.        _p_e_r_f_o_r_m_e_r__d_e_m_o._d_a_t_a._d_a_t_a
  111.             Sample Data and Fonts.  Need for the demos, installed
  112.             by default.
  113.  
  114.        _p_e_r_f_o_r_m_e_r__d_e_m_o._d_a_t_a._t_o_w_n
  115.             The Performer Town demo data.  Needed for the demos,
  116.             installed by default.
  117.  
  118.        _p_e_r_f_o_r_m_e_r__d_e_m_o._m_a_n._d_e_m_o
  119.             Reference pages for demo programs.  Installed by
  120.             default.
  121.  
  122.        _p_e_r_f_o_r_m_e_r__d_e_m_o._s_w._d_e_m_o
  123.             Demo executables (n32, OpenGL).  Installed by default.
  124.  
  125.  
  126.  
  127.  
  128.  
  129.  
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136.                                   - 3 -
  137.  
  138.  
  139.  
  140.        _p_e_r_f_o_r_m_e_r__d_e_m_o._s_w_6_4._d_e_m_o
  141.             Demo executables (n64, OpenGL).
  142.  
  143.        _p_e_r_f_o_r_m_e_r__e_o_e._s_w._p_e_r_f_o_r_m_e_r
  144.             N32 and O32 DSOs.  Required for basic operation.
  145.             Installed by default.
  146.  
  147.        _p_e_r_f_o_r_m_e_r__e_o_e._s_w_6_4._p_e_r_f_o_r_m_e_r
  148.             N64 DSOs.  Only required for 64-bit operation.
  149.  
  150.        _p_e_r_f_o_r_m_e_r__e_o_e._s_w._2__0
  151.             Performer 2.0.7 Compatibility DSOs.
  152.  
  153.        _p_e_r_f_o_r_m_e_r__e_o_e._s_w._2__1
  154.             Performer2.1.5 [2.1-2.1.4] Compatibility DSOs.
  155.  
  156.        _p_e_r_f_o_r_m_e_r__e_o_e._s_w._2__2
  157.             Performer2.2.10 Compatibility DSOs.
  158.  
  159.        _p_e_r_f_o_r_m_e_r__e_o_e._s_w_6_4._2__0
  160.             N64 64-bit Performer2.0.7 Compatibility DSOs.
  161.  
  162.        _p_e_r_f_o_r_m_e_r__e_o_e._s_w_6_4._2__1
  163.             N64 64-bit Performer2.1.5 Compatibility DSOs.
  164.  
  165.        _p_e_r_f_o_r_m_e_r__e_o_e._s_w_6_4._2__2
  166.             N64 64-bit Performer2.2.10 Compatibility DSOs.
  167.  
  168.  
  169.        2.3  _O_p_e_n_G_L__P_e_r_f_o_r_m_e_r__E_O_E__S_u_b_s_y_s_t_e_m__D_i_s_k__S_p_a_c_e__R_e_q_u_i_r_e_m_e_n_t_s
  170.  
  171.        This section lists the subsystems (and their sizes) of the
  172.        OpenGL Performer option.
  173.  
  174.        If you are installing this option for the first time, the
  175.        subsystems marked ``default'' are the ones that are
  176.        installed if you use the ``go'' menu item.  To install a
  177.        different set of subsystems, use the ``install,''
  178.        ``remove,'' ``keep,'' and ``step'' commands in _s_w_m_g_r or _i_n_s_t
  179.        to customize the list of subsystems to be installed, then
  180.        select the ``go'' action.
  181.  
  182.        Note:  The listed subsystem sizes are approximate.  Refer to
  183.               the _I_R_I_S _S_o_f_t_w_a_r_e _I_n_s_t_a_l_l_a_t_i_o_n _G_u_i_d_e for information
  184.               on finding exact sizes.
  185.  
  186.        Subsystem Name                         Subsystem Size
  187.                                               (1k-byte blocks)
  188.  
  189.  
  190.  
  191.  
  192.  
  193.  
  194.  
  195.  
  196.  
  197.  
  198.  
  199.  
  200.  
  201.  
  202.                                   - 4 -
  203.  
  204.  
  205.  
  206.        _p_e_r_f_o_r_m_e_r__d_e_m_o._d_a_t_a._d_a_t_a (default)          23900K
  207.        _p_e_r_f_o_r_m_e_r__d_e_m_o._d_a_t_a._t_o_w_n (default)           6250K
  208.        _p_e_r_f_o_r_m_e_r__d_e_m_o._m_a_n._d_e_m_o (default)              40K
  209.        _p_e_r_f_o_r_m_e_r__d_e_m_o._s_w._d_e_m_o (default)              960K
  210.        _p_e_r_f_o_r_m_e_r__d_e_m_o._s_w_6_4._d_e_m_o                      930K
  211.        _p_e_r_f_o_r_m_e_r__e_o_e._m_a_n._r_e_l_n_o_t_e_s (default)          130K
  212.        _p_e_r_f_o_r_m_e_r__e_o_e._s_w._2__0                        27380K
  213.        _p_e_r_f_o_r_m_e_r__e_o_e._s_w._2__1                        30040K
  214.        _p_e_r_f_o_r_m_e_r__e_o_e._s_w._2__2                        78480K
  215.        _p_e_r_f_o_r_m_e_r__e_o_e._s_w._p_e_r_f_o_r_m_e_r (default)        46120K
  216.        _p_e_r_f_o_r_m_e_r__e_o_e._s_w_6_4._2__0                       7680K
  217.        _p_e_r_f_o_r_m_e_r__e_o_e._s_w_6_4._2__1                       8430K
  218.        _p_e_r_f_o_r_m_e_r__e_o_e._s_w_6_4._2__2                      23250K
  219.        _p_e_r_f_o_r_m_e_r__e_o_e._s_w_6_4._p_e_r_f_o_r_m_e_r                26000K
  221.  
  222.  
  223.        2.4  _I_n_s_t_a_l_l_a_t_i_o_n__M_e_t_h_o_d
  224.  
  225.        All of the OpenGL Performer subsystems can be installed
  226.        using IRIX.  You do not need to use the miniroot.  Refer to
  227.        the _I_R_I_S _S_o_f_t_w_a_r_e _I_n_s_t_a_l_l_a_t_i_o_n _G_u_i_d_e for complete
  228.        installation instructions. Detailed information about both
  229.        the _s_w_m_g_r and _i_n_s_t installation management tools is
  230.        available through the _m_a_n and _x_m_a_n commands.
  231.  
  232.  
  233.        2.5  _C_o_m_p_a_t_i_b_i_l_i_t_y
  234.  
  235.        This distribution contains the OpenGL Performer 2.4
  236.        execution environment which also contains compatibility
  237.        subsystems with bug fixes for previous versions of IRIS
  238.        Performer.  Applications compiled with the IRIS Performer
  239.        2.2, 2.0 or 2.1 DSOs will run unmodified with the IRIS
  240.        Performer 2.2.10, 2.0.7 and 2.1.5 DSOs, respectively, across
  241.        all SGI platforms.  The Performer DSOs are versioned so DSOs
  242.        from multiple versions of Performer can co-exist and
  243.        applications will automatically run with their proper
  244.        version.
  245.  
  246.  
  247.        2.6  _I_n_s_t_a_l_l_a_t_i_o_n__L_o_c_a_t_i_o_n_s
  248.  
  249.        The OpenGL Performer execution environment places DSOs under
  250.        "/_u_s_r/_l_i_b", "/_u_s_r/_l_i_b_3_2", and "/_u_s_r/_l_i_b_6_4" for O32, N32, and
  251.        N64 versions, respectively.
  252.        The compiled versions of the database loading and utility
  253.        libraries are placed under "/_u_s_r/_l_i_b/_l_i_b_p_f_d_b",
  254.        "/_u_s_r/_l_i_b_3_2/_l_i_b_p_f_d_b", and "/_u_s_r/_l_i_b_6_4/_l_i_b_p_f_d_b".
  255.        It is these libraries that are dynamically loaded and which
  256.        must be accessible for Performer applications to
  257.  
  259.  
  260.  
  261.  
  262.  
  263.  
  264.  
  265.  
  266.  
  267.                                   - 5 -
  268.  
  269.  
  270.  
  271.        successfully execute.
  272.  
  273.  
  274.  
  275.  
  276.  
  277.  
  278.  
  279.  
  280.  
  281.  
  282.  
  283.  
  284.  
  285.  
  286.  
  287.  
  288.  
  289.  
  290.  
  291.  
  292.  
  293.  
  294.  
  295.  
  296.  
  297.  
  298.  
  299.  
  300.  
  301.  
  302.  
  303.  
  304.  
  305.  
  306.  
  307.  
  308.  
  309.  
  310.  
  311.  
  312.  
  313.  
  314.  
  315.  
  316.  
  317.  
  318.  
  319.  
  320.  
  321.  
  322.  
  323.  
  324.  
  325.  
  326.  
  327.  
  328.  
  329.  
  330.